== OnTime ==

This plugin tracks the playing time for all players in a simple and lightweight file-based DB. (No SQL required)  With this plugin a top xx list can be generated in game, current and total playing statistics can be displayed (also in game), and daily reports of all players can be generated and viewed (off line).  Administrators can define// OnTime Reward// levels which will cause Econ amounts, MC Items, permission group changes, and **permission grants**  to be automatically issued to a player when they have achieved a specified total playtime on the server.  [[http://dev.bukkit.org/server-mods/vault/|Vault]] is used so //OnTime Rewards// and permissions are supported by multiple economy and permission plugins.

=== Features: ===
**(Items in BOLD are new in the latest 2.1 release of OnTime)**
* Display your own OnTime: current login, daily, and total time on the server
* Display anther player's OnTime data: days since first login, different days on server, current login time, current day's time, total server time, and next //OnTime reward//
* Display all online players current session and total time
* Display top # players, ranked by total time
* Define economy rewards issued to players for their time played on the server
* Define MC item rewards issued to players for their time played on the server
* **Define Econ and Item rewards as recurring
* Automatically change permission group for players when they reach a specified time on the server. 
* **Grant a player with a new permission when they reach a specified time on the server
* Display of the next rewards to be issued to all online players
* Display of last login time stamp in top # list
* Display of player's 'today' time in top # list
* Set a player's //total OnTime//
* **Set a player's number of different days on server
* Add time to a player's //total OnTime//
* Remove a player from the OnTime data files
* Generate a report file (.txt) of all players total time and time stamp of last login event
* Generate a report file (.txt) of all players time on your server today
* Auto generation of total and daily reports
* Auto-purge inactive or players with low total OnTime from the data files
* Scheduled saves of OnTime data to disk
* Auto update of all online players data, file save, and data purge on server shutdown/reset
* 'test commands to simulate login/logout events creating fake OnTime records / test daily reports
* Logging of OnTime auto purge activity, player login and quit events, and reward system events
* Use of [[http://dev.bukkit.org/server-mods/vault/|Vault]] for support of multiple economy and permission plugins
* **Integration with Vault Permissions for group changes and permissions add
>
\\
> Please see the [[http://dev.bukkit.org/server-mods/ontime/pages/|pages]] for permissions, configuration, commands, etc.
\\
=== Installation ===
# Place ontime.jar in your plugin folder
# Download  [[http://dev.bukkit.org/server-mods/vault/|vault.jar]] and place that also in your plugin folder
# (Option) Download Essentials [[http://dev.bukkit.org/server-mods/essentials/|GroupManager.jar]] ** or another Vault supported permissions plugin** and place that in your plugin folder
# Reset your server
\\
\\
If the **optional** Permissions plugin is installed, the following steps must be taken.
# Edit /plugin/ontime/rewards.yml, listing the permissions groups from lowest to highest under the 'groups:' keyword
# Reset your server again
=== Feature Requests: === 
> If you want to request a feature to be added to this plugin, submit a ticket 

=== Please Leave Comments ===
I'd love to hear what you think (good and bad) about this plugin.  It will help me know if its worth keeping up on the maintenance.  Thanks. Edge

=== Change Log ===
* v1.0 - Initial upload version (alpha)
* v1.1 - Initial public release
* v1.2 - Fixed typo in report file
* v1.3.0 - tested with CB 1.7 / added daily usage tracking & reports / added remove command
* v1.4.0 - Added OnTime Rewards system and related commands; fixed exception errors on '/ontime' and '/ontime <userid>' commands
* v1.4.1 - Fixed minor error in rewards.yml file generation
* v2.0.0 - Added Item and Group rewards; added 'set' and 'add' commands; added more info to user data display; fixed 'daily' data file corruption error
* v2.0.1 - Improved handling for servers without Essentials GroupManager; Added log entries for use of 'remove', 'set', and 'add' commands.
* v2.1.0 - Added Permission rewards; Added recurring econ and item rewards; Added 'set days' command; Integrated with Vault Permissions (simplified group reward configuration); Fixed 'days on' counting error